home *** CD-ROM | disk | FTP | other *** search
/ Software Vault: The Gold Collection / Software Vault - The Gold Collection (American Databankers) (1993).ISO / cdr31 / arc2zip.zip / CONVERT.MAN < prev   
Text File  |  1993-05-13  |  10KB  |  331 lines

  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.           
  8.  
  9.           
  10.  
  11.           
  12.  
  13.           
  14.  
  15.           
  16.  
  17.                                           
  18.  
  19.                                           
  20.  
  21.                                        CONVERT
  22.  
  23.                            Copyright (c) 1989 by Tony Kyle
  24.  
  25.                                  All Rights Reserved
  26.  
  27.                                           
  28.  
  29.                               Released to Public Domain
  30.                                      March 1989
  31.  
  32.                                           
  33.  
  34.                     PKXARC, PKUNPAK and PKZIP are copyrighted and
  35.                             Traded Marked by PKWare, Inc.
  36.           
  37.  
  38.  
  39.  
  40.  
  41.  
  42.  
  43.  
  44.  
  45.  
  46.  
  47.  
  48.  
  49.  
  50.  
  51.  
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.  
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.           CONVERT (c) 1989                             Page -2-
  71.  
  72.  
  73.           With PKWare's latest release, PKZIP and PKUNZIP, the users of
  74.           bulletin boards, and shareware in general, are left with a
  75.           problem.  Do we take the immense task of converting from PKXARC
  76.           or PKPAK ARC formats to ZIP, or do we live with the possibility
  77.           of becoming obsolete.  The process itself is not complicated.
  78.           Un-compress the files, one archive at a time, then convert to the
  79.           new format.  Batch files can even be written to ease the pain and
  80.           boredom that results.
  81.  
  82.           However, would it not be better and easier to be able to CONVERT
  83.           whole disks or sub-directories at a time?  A program that could
  84.           be used with either PKXARC (tm) or PKUNPAK (tm).  CONVERT is just
  85.           the program for this task.
  86.  
  87.           After the lawsuit brought by SEA, Inc. against PKWare, Inc. in
  88.           Wisconsin this past summer (1988), it was not a question if
  89.           PKWare would change, or even when.  That was all spelled out in
  90.           the out-of-court agreement reached by the two parties.  All that
  91.           was left, is how is the average user going to be affected by the
  92.           change.  In Oklahoma City, one BBS has started the process of
  93.           changing from ARCs to ZIPs.  With 30 some odd disks in ARC
  94.           format, I did not relish the task of hand converting from one
  95.           format to the other.  I wrote CONVERT to be used by anyone who
  96.           has a number of disks in the old format and desires to change to
  97.           the new format.  I have converted all of my disks, and even files
  98.           on my hard drive using this program without experiencing any
  99.           problems from its use.
  100.  
  101.           Before entrusting your entire collection of ARC files to CONVERT,
  102.           please take the time to test it on some practice disks.  In other
  103.           words, copy a couple of your normal archive file disks to blank
  104.           floppies and then run CONVERT on them to ensure that the program
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.  
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136.           CONVERT (c) 1989                             Page -3-
  137.  
  138.  
  139.           is working properly.  There is always the possibility that the
  140.           program could have become garbled during the download process or
  141.           may just not work with your hardware/software combination.
  142.  
  143.           CONVERT is a command line driven utility.  I do not seek any
  144.           charges for use of the program.  In other words, plain and
  145.           simple, IT'S FREE.
  146.  
  147.           The programmer does not take any responsibility for losses or
  148.           damages brought about by the use of this program, either real or
  149.           punitive, loss of earnings, savings or any other losses that
  150.           could result from the careless or inappropriate use of this
  151.           software.  This program is provided AS-IS, with no warranty
  152.           available to the end user.  The user has and will bear sole
  153.           responsibility for the use of this program.
  154.  
  155.           If there are problems, notify me, with a complete description of
  156.           your system, the hardware and software used, including version
  157.           numbers and what, if any error codes you receive, either from
  158.           your system or from the program.  I will make every attempt to
  159.           reproduce the problems on my machine in order to correct any
  160.           program problems.
  161.  
  162.           The program does not erase any files until the whole disk or sub-
  163.           directory is CONVERTed.  If enough space is not provided on the
  164.           work drive, you could lose the files on the source
  165.           drive/directory.  However, if you give it a sub-directory that is
  166.           either not present on the drive specified, or have mis-spelled
  167.           the directory's name, the program will abort without doing
  168.           anything.
  169.  
  170.           As I stated earlier, the program is command-line driven.  To use,
  171.           you would enter at the DOS prompt:
  172.  
  173.                CONVERT # Drive:[\Sub-directory]
  174.  
  175.                     # is 1 for PKUNPAK
  176.                          2 for PKXARC
  177.                     (This is required)
  178.  
  179.                     Drive is the source drive for the archived files
  180.                     (This is required)
  181.  
  182.                     Directory is the source directory, if any, for the      
  183.                     archived files
  184.                     (This is optional)
  185.  
  186.           The portion between the brackets ([..]) is optional.  If you only
  187.           use the root directory of your drives, then you need not specify
  188.           a directory.  However, if you use your hard drive like a file
  189.           cabinet, and each sub-directory is a folder, then you would
  190.           specify where CONVERT is to find the archived files for
  191.           processing.  CONVERT will also place the processed files back
  192.           into the specified directory when it is done.
  193.  
  194.  
  195.  
  196.  
  197.  
  198.  
  199.  
  200.  
  201.  
  202.           CONVERT (c) 1989                             Page -4-
  203.  
  204.  
  205.           There are some program requirements that must be met before you
  206.           can properly utilize CONVERT.
  207.  
  208.           The first is, the program creates two (2) sub-directories.  One
  209.           is called FROMARC, the other TOZIP.  If by chance, you have a
  210.           directory on your drive with these names, you will need to change
  211.           your directory's names before and while using CONVERT.
  212.  
  213.           Second, the program creates two (2) small, temporary files called
  214.           TEMPCD and TEMP.DIR.  TEMPCD is used to store the information
  215.           about the current directory.  This is necessary for the program,
  216.           as CONVERT will return to the starting directory when it is
  217.           completed.  TEMP.DIR is a file holding the directory listing of
  218.           the disk/directory being processed by the program.  By using a
  219.           text file with the filenames stored in it, CONVERT can work
  220.           unattended.
  221.  
  222.           Third, PKUNPAK (if you are using PKUNPAK), PKXARC (if you are
  223.           using PKXARC), and PKZIP (this is required) MUST be in the
  224.           pathway for your system.
  225.  
  226.           Fourth, the hard drive memory requirements depend on the type of
  227.           disks you have your archives stored on.  If your files are on the
  228.           hard drive, then you should allot an amount triple to the size of
  229.           the largest directory being CONVERTed.  If you are using
  230.           floppies, then the space required on the hard drive is about
  231.           double to triple the amount of the floppy being used.  For 360K
  232.           floppies, allot 1 meg of hard drive space.  For 720K disks, allot
  233.           2 to 3 meg, and for 1.2 or 1.44 meg disks, allot 4 to 6 megabytes
  234.           of hard drive space.  The reasons for the memory requirements are
  235.           simple.  CONVERT does not write the processed file back to the
  236.           drive or directory, until all files have been processed.  CONVERT
  237.           uses the directory, TOZIP, to store the processed files.  After
  238.           the ARCed files have been processed, CONVERT erases all of the
  239.           files with the extension of ARC off of the source drive and/or
  240.           directory, then copies the ZIP files over.  For exampled:
  241.  
  242.                You use 360K disks for archived files.  On the 360K
  243.                disk, you have used 280 or 300K.  The largest file de-
  244.                compresses to 400K.  The files, all ZIPed, account for
  245.                260 to 290K plus the space that was required to process
  246.                them, in this case approximately 400K for the largest
  247.                de-compressed file.  Total space used would be 460 to
  248.                490K.
  249.  
  250.           Some files take more, others less.  However, by allowing for
  251.           extra space, you will avoid the heartache of receiving the
  252.           "Insufficient Memory", message, which could result in loss of
  253.           files.  Again, I converted over 30 disks without a loss.  I pack
  254.           my disks as tight as possible, leaving, in at least 2 cases, no
  255.           free space on the floppy.
  256.  
  257.  
  258.  
  259.  
  260.  
  261.  
  262.  
  263.  
  264.  
  265.  
  266.  
  267.  
  268.           CONVERT (c) 1989                             Page -5-
  269.  
  270.  
  271.           When you convert, you will actually create some free space, as
  272.           the ZIP programs, with software switches already set by CONVERT,
  273.           will pack your files even tighter than PKARC could.  The switches
  274.           are set for PKZIP as follows:
  275.  
  276.                     PKZIP -ea4 -eb4 -m
  277.  
  278.           The "-ea4" and "-eb4" allow for the tighter compression.  The "-
  279.           m" allows for the processed files to be "moved", so there is no
  280.           need to for CONVERT to delete these files.  For more information,
  281.           you should probably read the documentation that comes with
  282.           PKWare's products.  It gives a much fuller explanation than I
  283.           could possibly give.
  284.  
  285.  
  286.  
  287.  
  288.  
  289.  
  290.  
  291.  
  292.  
  293.  
  294.  
  295.  
  296.  
  297.  
  298.  
  299.  
  300.  
  301.  
  302.  
  303.  
  304.  
  305.  
  306.  
  307.  
  308.  
  309.  
  310.  
  311.  
  312.  
  313.  
  314.  
  315.  
  316.  
  317.  
  318.  
  319.  
  320.  
  321.  
  322.  
  323.  
  324.  
  325.  
  326.  
  327.  
  328.  
  329.  
  330.  
  331.